home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / plan / src / plan.1cat < prev    next >
Text File  |  1994-08-01  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.      PPPPLLLLAAAANNNN((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  PPPPLLLLAAAANNNN((((1111LLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           plan - interactive X/Motif calendar and day planner
  10.           pland - daemon for _p_l_a_n
  11.           notifier - X/Motif text displayer for _p_l_a_n
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ppppllllaaaannnn [-h] [-d] [-v] [-t [D]] [-s] [-f] [-k]
  15.           ppppllllaaaannnn [mmdd]hhmm [_m_e_s_s_a_g_e]*
  16.           ppppllllaaaannnndddd [-kK]
  17.           nnnnoooottttiiiiffffiiiieeeerrrr [-hdv123] [-t_t_i_t_l_e] [-i_i_c_o_n_t_i_t_l_e] [file]
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.           ppppllllaaaannnn is a schedule planner based on X/Motif. It displays a
  21.           month calendar similar to xcal, but every day box is large
  22.           enough to show appointments in small print. By pressing on a
  23.           day box, the appointments for that day can be listed and
  24.           edited. This manual page describes the command line options
  25.           of ppppllllaaaannnn.  For information on how to use ppppllllaaaannnn, refer to the
  26.           on-line help pages.
  27.  
  28.           ppppllllaaaannnn has two modes: it starts up with a window in
  29.           interactive mode if started without date/time string; with
  30.           date/time on the command line it adds an appointment to the
  31.           list. Only one interactive ppppllllaaaannnn per user can run at any
  32.           time.
  33.  
  34.           ppppllllaaaannnndddd is a daemon that watches for appointment triggers. The
  35.           daemon is normally started from your .sgisession or
  36.           .xsession file. It puts itself in the background. If ppppllllaaaannnn is
  37.           started, it checks for the existence of the daemon, and
  38.           offers to start one if it can't find it.
  39.  
  40.           nnnnoooottttiiiiffffiiiieeeerrrr displays the standard input in a window, with
  41.           appropriate titles and background colors. The only program
  42.           that ever uses it is the daemon; it is a separate program
  43.           only to keep the daemon small.
  44.  
  45.         OOOOPPPPTTTTIIIIOOOONNNNSSSS OOOOFFFF PPPPLLLLAAAANNNN
  46.           -h   List available options.
  47.  
  48.           -d   Print fallback X resources and exit. The output can be
  49.                appended directly to the ~/.Xdefaults file for
  50.                modification of the geometry, color, and font defaults.
  51.  
  52.           -v   Print the program version and patchlevel and exit.
  53.  
  54.           -t [D]
  55.                Print a list of today's appointments to stdout. Don't
  56.                start up interactive windows. The exit status is 0 if
  57.                there are appointments on the specified date, and 1
  58.                otherwise. If a date D is specified, print appointments
  59.                on that date. All standard date specifiers work:
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/11/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPLLLLAAAANNNN((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  PPPPLLLLAAAANNNN((((1111LLLL))))
  71.  
  72.  
  73.  
  74.                -t +3        Print appointments in three days
  75.  
  76.                -t -1        Print yesterday's appointments
  77.  
  78.                -t tomorrow  Print appointments for tomorrow
  79.  
  80.                -t thursday  Print appointments for Thursday
  81.  
  82.                -t 25.12.    Print appointments for Christmas, if 24-
  83.                             hour mode is selected
  84.  
  85.                -t 12/25     Print appointments for Christmas, if 12-
  86.                             hour mode is selected.  12/24 hour mode is
  87.                             selected with the Config pulldown in the
  88.                             main window.
  89.  
  90.           -s   Standalone, don't offer to start daemon if none exists.
  91.                Without daemon, no appointment alarms and warnings will
  92.                trigger. If a daemon happens to exist, it is notified
  93.                when the database changes, but no warning is printed if
  94.                it doesn't.
  95.  
  96.           -f   Don't fork on startup. This is useful for debugging.
  97.  
  98.           -k   If there appears to be another ppppllllaaaannnn running, start up
  99.                anyway. This is useful if a /tmp/.plan<uid> file got
  100.                accidentally left behind, and plan fails to check
  101.                whether the older plan still exists. This option is
  102.                largely obsolete in version 1.2.
  103.  
  104.           [mmdd]hhmm [message]*
  105.                Add an appointment at mm/dd hh:mm (month/day
  106.                hours:minutes). If mmdd is not specified, today's date
  107.                is used. The message, which should be quoted if it
  108.                contains shell metacharacters, is used as note string.
  109.                No menus will start up. No option may be specified.
  110.  
  111.         OOOOPPPPTTTTIIIIOOOONNNNSSSS OOOOFFFF PPPPLLLLAAAANNNNDDDD
  112.           -k   If another daemon exists, kill it and restart.
  113.  
  114.           -K   (cap-K) If another daemon exists, kill it and exit.
  115.  
  116.         OOOOPPPPTTTTIIIIOOOONNNNSSSS OOOOFFFF NNNNOOOOTTTTIIIIFFFFIIIIEEEERRRR
  117.           -h   List available options.
  118.  
  119.           -d   Print fallback X resources and exit. The output can be
  120.                appended directly to the ~/.Xdefaults file for
  121.                modification of the geometry, color, and font defaults.
  122.  
  123.           -v   Print the program version and patchlevel and exit.
  124.  
  125.           -1   Set the window background color to green (early
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/11/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PPPPLLLLAAAANNNN((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  PPPPLLLLAAAANNNN((((1111LLLL))))
  137.  
  138.  
  139.  
  140.                warning).
  141.  
  142.           -2   Set the window background color to yellow (late
  143.                warning).
  144.  
  145.           -3   Set the window background color to red (alarm). This is
  146.                the default.
  147.  
  148.           -t_t_i_t_l_e
  149.                Set the title string above the message text (which is
  150.                read from stdin).
  151.  
  152.           -i_i_c_o_n_t_i_t_l_e
  153.                Set the icon title string that is printed below the
  154.                mwm/4Dwm icon.
  155.  
  156.           In addition to these options, plan and notifier support the
  157.           usual X options -iconic and -geometry.
  158.  
  159.      FFFFIIIILLLLEEEESSSS
  160.           Below, DIR and LIB refer to the installation directories
  161.           specified at the beginning of the Makefile when the programs
  162.           were compiled. Both are /usr/local/bin by default. These are
  163.           the directories where ppppllllaaaannnn and ppppllllaaaannnndddd first search for
  164.           executables and plan.help; next, $PLAN_PATH and $PATH are
  165.           searched, and finally, a built-in search path that also
  166.           contains "." as its last item.
  167.  
  168.           ~/.dayplan
  169.                Database with all public entries and configuration
  170.                options of ppppllllaaaannnn.  See plan(4) for details.
  171.  
  172.           ~/.dayplan.priv
  173.                Database with all private entries.
  174.  
  175.           ~/.holiday
  176.                Definition of holidays. See the help text for the
  177.                "Define Holiday" popup menu that can be installed with
  178.                the Holiday pulldown.
  179.  
  180.           /tmp/.planUID
  181.                Lockfile that contains the PID of ppppllllaaaannnn.  Used to
  182.                prevent multiple ppppllllaaaannnn instances, and to send HUP
  183.                signals to if a non-interactive ppppllllaaaannnn invocation changed
  184.                the database. UID is the user's numerical user ID.
  185.  
  186.           /tmp/.plandUID
  187.                Lockfile that contains the PID of the ppppllllaaaannnndddd daemon.
  188.                Used to prevent multiple daemons, and to send HUP
  189.                signals to if the database changed for any reason. UID
  190.                is the user's numerical user ID.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/11/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      PPPPLLLLAAAANNNN((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  PPPPLLLLAAAANNNN((((1111LLLL))))
  203.  
  204.  
  205.  
  206.           plan
  207.                The ppppllllaaaannnn program.
  208.  
  209.           LIB/pland
  210.                The ppppllllaaaannnndddd daemon. It must be in the BIN or LIB
  211.                directory, or in one of the directories in one of the
  212.                search paths.
  213.  
  214.           notifier
  215.                The nnnnoooottttiiiiffffiiiieeeerrrr program. It must be in the BIN or LIB
  216.                directory, or in one of the directories in one of the
  217.                search paths.
  218.  
  219.           plan.help
  220.                The online help texts used by ppppllllaaaannnn.  It must be in the
  221.                BIN or LIB directory, or in one of the directories in
  222.                one of the search paths.
  223.  
  224.         AAAAUUUUTTTTHHHHOOOORRRR
  225.           Thomas Driemeyer <thomas@bitrot.in-berlin.de>
  226.           Please send all complaints, comments, bug fixes, and porting
  227.           experiences to me. Always include your plan version as
  228.           reported by "plan -v" in your mail.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 7/11/94)
  262.  
  263.  
  264.  
  265.